home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr39 / bpq406f.zip / PROGS.DOC < prev    next >
Text File  |  1993-04-25  |  11KB  |  331 lines
  1.  
  2. The following programs are provided.
  3.  
  4. BPQCODE.EXE
  5.  
  6.     The TSR version of the packet switch. It provides a NET/ROM compatible
  7.     packet switch, and an interface to application-level software (such as
  8.     a BBS).
  9.  
  10.  
  11. SWITCH.EXE
  12.  
  13.     This is a foreground version of BPQCODE. It is intended to run only as
  14.     a packet switch, and not to support an application system (eg BBS). A
  15.     simple terminal program (equivalent to PAC4) is built in, as is the
  16.     SYSOP handler from the Data Engine version of the switch. The diffences  
  17.     from BPQCODE are listed below:
  18.  
  19.     BPQCFG.TXT
  20.  
  21.     This can be the same as for the normal version. The code will assume
  22.     NODE=1 and BBS=0, whatever is entered. 
  23.  
  24.  
  25.     Terminal support.
  26.  
  27.     See PAC4 below for details. Ctrl/Y shuts down the whole switch.
  28.  
  29.  
  30.     SYSOP Commands.
  31.  
  32.     The SYSOP feature is similar to SYSOPH, but the password protection
  33.     works rather differently. To enter SYSOP mode, enter PASSWORD. If 
  34.     you are using the console, the switch will respond Ok, and enter 
  35.     SYSOP mode. If you are accessing the system remotely, it will respond 
  36.     with 5 random numbers. You must reenter PASSWORD, this time followed 
  37.     by the corresponding characters from the password string contained 
  38.     in the file PASSWORD.BPQ. If these are correct the switch responds 
  39.     OK, otherwise it ignores the message.
  40.  
  41.     So, if the password string is ABCDEFGHIJKLM the following is a
  42.     typical sequence:
  43.  
  44.         PASSWORD
  45.         BPQ:G8BPQ} 04 02 05 06 03
  46.         PASSWORD DBEFC
  47.         BPQ:GBBPQ} Ok
  48.  
  49.     Note that the password is converted to upper case before testing, so 
  50.     PASSWORD.BPQ should contain upper case letters or digits. It should
  51.     not contain spaces or other special characters.
  52.  
  53.     There are a number of extra SYSOP commands. These were added primarily
  54.     for the Data Engine version, where experimenting with parameters is 
  55.     rather more difficult, but I've left them in this version as well.
  56.     
  57.         Command        Corresponding BPQCFG parameter
  58.  
  59.         OBSINIT            OBSINIT
  60.         OBSMIN            OBSMIN
  61.         NODESINT        NODESINTERVAL
  62.         L3TTL            L3TIMETOLIVE 
  63.         L4RETRIES        L4RETRIES
  64.         L4TIMEOUT        L4TIMEOUT
  65.         T3            T3
  66.         IDLETIME        IDLETIME
  67.         LINKEDFLAG        ENABLE_LINKED
  68.         IDINTERVAL        IDINTERVAL
  69.         MINQUAL            MINQUAL
  70.         FULLCTEXT        FULL_CTEXT
  71.         HIDENODES        HIDENODES
  72.         L4DELAY            L4DELAY
  73.         L4WINDOW        L4WINDOW
  74.         BTINTERVAL        BTINTERVAL
  75.  
  76.     There is also one commend which isnt in the DE version - SAVENODES.
  77.  
  78.  
  79. IPGATE.EXE
  80.  
  81.     An IP router to run above the switch (Normally in a DesqView window). See
  82.     IPGATE.DOC for further information.
  83.  
  84.  
  85. ODIDRV.EXE
  86.  
  87.     An EXTERNAL hardware driver to link switches via Ethernet (using Novell's
  88.     ODI interface). See DRIVERS.DOC for further information.
  89.  
  90.  
  91. BPQCFG.EXE
  92.  
  93.     This program converts the configuration file BPQCFG.TXT to a binary file
  94.     (BPQCFG.BIN) for use by the switch software. It must be run after any
  95.     change to BPQCFG.TXT.
  96.  
  97.  
  98.  
  99. BPQNODES.COM
  100.  
  101.  
  102.     This program dump the ROUTES and NODES tables to a file (BPQNODES). This
  103.     file is then used to initialise the above tables when the switch is 
  104.     reloaded. It should be run before reloading the switch, and if possible
  105.     at regular intervals, so that if the system crashes, it comes back with
  106.     a reasonably up-to-date view of the network. Many BBS systems allow you
  107.     to run a program as part of the forwarding cycle, or at specified times.
  108.  
  109.  
  110.     It is possible to edit the BPQNODES file. This provides a way of defining
  111.     Route Qualities, etc. without changing BPQCFG.TXT, or using SYSOPH.
  112.  
  113.     The file format is: ( {} indicates optional entries - don't include the{})
  114.  
  115.     ROUTE ADD CALL P QUAL {!} {VIA DIGI1 {DIGI2}}
  116.  
  117.     where P is the port, QUAL the Quality, and the optional ! indicates a
  118.     locked route. Up to 2 DIGIS may be specified. 
  119.  
  120.     NODE ADD ALIAS:CALL CALL-1 P QUAL {!} {CALL-2 P QUAL {!} } {CALL-3 ....}
  121.  
  122.     where CALL-1, CALL-2, CALL-3 are up to 3 alternate routs, which must be
  123.     defined (by ROUTES config entries or ROUTE ADD) before being used.
  124.  
  125.     Although locked nodes are allowed, I strongly recommend that they are used
  126.     only in exceptional circumstances (eg when using a digi'ed route). Note
  127.     also that a locked route to a node will be removed if the system finds 3 
  128.     higher quality routes to it.
  129.  
  130.  
  131.     Lines beginning with ; are treated as comments, and fields should be
  132.     separated by one (and only one) space.
  133.  
  134.  
  135.  
  136.  
  137. BPQDUMP.COM
  138.  
  139.  
  140.     BPQDUMP.COM  is a simple program to dump my code to a file to aid
  141.     diagnosis of fault conditions. It creates a file in the current directory
  142.     called BPQDUMP (about 98k).
  143.  
  144.     If run without a parameter, it dumps immediately.
  145.  
  146.     If a param is specified, it will loop until the free buffer count drops
  147.     below 20 ( the point when the code starts to shut down), then dumps and
  148.     exits. Note this mode must only be run in a desqview window.
  149.  
  150.  
  151.     eg
  152.  
  153.     BPQDUMP        - dumps now
  154.  
  155.     BPQDUMP X    - dumps when buffers < 21
  156.  
  157.  
  158.  
  159. PAC2.COM
  160.  
  161.  
  162.     PAC2 is a small, simple terminal program, primarily for use with my switch,
  163.     but it also works with a normal TNC + COMBIOS. It has one paramter (port
  164.     number), so enter PAC2 N, where N is the (virtual) COMBIOS port you want
  165.     to access. The program provides a buffered input line, which allows use of
  166.     the editing keys ins, del, cul, cur, etc, It allows logging to disk (CTRL/L
  167.     toggles this function on and off), and maintains a simple 'Response Time
  168.     Monitor' function - useful for seeing how badly the network is performing!
  169.  
  170.     To exit from PAC2, enter CTRL/Y
  171.  
  172.  
  173. PAC4.EXE
  174.  
  175.  
  176.     PAC4 is a simple terminal program, which uses the BPQ Host Mode to talk
  177.     to the switch. The program provides a buffered input line, which allows
  178.     use of the editing keys ins, del, cul, cur, etc. It allows logging to disk
  179.     (CTRL/L toggles this function on and off), and maintains a simple 'Response
  180.     Time Monitor' function. A scroll-back buffer is also provided - use PageUp
  181.     and PageDown to scroll.
  182.  
  183.  
  184.     The program has one required paramter (port number), and a second optional
  185.     one (M for mono mode). So possible command lines are:
  186.  
  187.     PAC4 63            ; to use stream 63
  188.  
  189.     PAC4 1 M        ; to use stream 1, if you have a mono monitor.
  190.  
  191.     Connection is made to the switch when a message is input. The ESC key 
  192.     disconnects you from the switch.
  193.  
  194.     Monitoring is toggled on/off using F1. F2 toggles MCOM mode (monitoring of
  195.     control frames as well as info frames). F3 allows you to set MMASK. Press
  196.     F3, then key up to 4 hex digits, terminated with a newline. Each bit of
  197.     MMASK enables the monitoring of the corresponding radio port. Bit 0 
  198.     enables port 1, bit 15 port 16. Any combination of bits may be set. The 
  199.     current monitor settings are displayed on the status line.
  200.  
  201.  
  202.     To exit from PAC4, enter CTRL/Y
  203.  
  204.  
  205. SYSOPH.COM
  206.  
  207.  
  208.  
  209.     This program allows the manipulation of certain parameters within the
  210.     switch. The program may be run as a normal DOS program, either in a
  211.     Desqview window or standalone, or it may run as a TSR. The TSR mode would
  212.     normally be used if you were running a BBS system that doesnt need 
  213.     DesqView (eg AA4RE). In TSR mode, commands cannot be entered locally, and 
  214.     the SAVENODES command is disabled. It either mode, it may be accessed over
  215.     the network. 
  216.  
  217.     The system has now been modifed to use BPQHOST mode rather than a virtual
  218.     TNC2 port. Program SYSOP.COM is withdrawn.
  219.  
  220.  
  221.     Installation.
  222.  
  223.     1. Add a suitible application name as the third APPLICATIONS Param, ie
  224.  
  225.        APPLICATIONS=BBS,,*SYSOP
  226.  
  227.        I suggest you use a name starting with a '*', as this will 'hide' the
  228.        command from the Valid Commands display.
  229.  
  230.     2« Creatσ ß file¼ PASSWORD.BPQ, containing a string of up to 80 characters.
  231.  
  232.     3. Run program SYSOPH, with a single parameter of the stream to be used,
  233.        either on its own, or in a DesqView window. If a second parameter of
  234.        'RESIDENT' is specified, the program will become a TSR routine.
  235.  
  236.  
  237.  
  238.     Commands may now be entered directly on the PC, (unless in TSR mode) or
  239.     remotely by connecting to the Node, and entering the APPL name (eg *SYSOP). 
  240.     When accessed remotely, a password prompt is sent, containing 5 random
  241.     numbers in the range 1 to the length of the PASSWORD.BPQ string. The first
  242.     command entered must be the corresponding five letters from the password
  243.     string, or the user will be disconnected.
  244.  
  245.     Available Commands.
  246.  
  247.     The following commands are supported:
  248.  
  249.     BYE - Disconnect remote user (even if entered from console)
  250.  
  251.     TXDELAY
  252.     MAXFRAME
  253.     FRACK
  254.     RESPTIME
  255.     PACLEN
  256.     RETRIES
  257.     QUALITY
  258.     PERSIST
  259.     TXTAIL
  260.     XMITOFF
  261.     DIGIFLAG
  262.     DIGIPORT
  263.     USERS
  264.     VALIDCALL
  265.     L3ONLY
  266.     BBSALIAS
  267.     SOFTDCD
  268.     
  269.        The above display or update the parameter for a specified port,
  270.     
  271.        eg   PACLEN 1 100
  272.             PERSIST 2 50
  273.     
  274.        If the third parameter is omitted, the current value is displayed.
  275.     
  276.        Setting XMITOFF will supress all TX activity on a port (including CWID,
  277.        beacons, etc). I put it in so I could monitor the satellites without
  278.        causing QRM, but it could be used as a way of shutting down a port in
  279.        an emergency.
  280.     
  281.        Setting BBSALIAS will cause connects to the port call or port alias to
  282.        go to the BBS rather than the node.
  283.  
  284.    It is not currently possible to update VALIDCALLS, but you can display
  285.    the current setting.
  286.  
  287.  
  288.    *** Warning ***  
  289.  
  290.      At the moment the FRACK value is in 1/3sec units, and the TXDELAY is in
  291.      50ms units for HDLC cards, and 10ms units for KISS TNCs. I'll be sorting
  292.      this out when I get the time to rationalize the timer code, but in the 
  293.      meantime, I suggest you make a note of the current values before you
  294.      start fiddling. 
  295.  
  296.      Also KISS users should note that the params are only sent to the TNC every
  297.      5 mins or so, so the updated values may not take effect for a while.
  298.  
  299.  
  300.    ROUTES
  301.  
  302.        To display ROUTES table, enter ROUTES
  303.  
  304.        To display entry for a particular neighbour, enter ROUTES Call Port,
  305.  
  306.        eg   ROUTES G8BPQ-2 2
  307.  
  308.        To update an entry, enter ROUTES Call Port Params
  309.  
  310.        eg   ROUTES G8BPQ-2 2 100    - Set quality to 100
  311.             ROUTES G8BPQ-2 2 !         - Toggle 'Locked Route' flag
  312.  
  313.        To clear the stats counters on a route, enter:
  314.  
  315.             ROUTES G8BPQ-2 2 Z
  316.  
  317.  
  318.     SAVENODES (Not available in TSR mode).
  319.  
  320.        Writes the ROUTES and NODES tables to the BPQNODES file.
  321.  
  322.        The SAVENODES function may also be invoked directly from the DOS command
  323.        line - this function replaces BPQNODES.COM
  324.  
  325.            ie.  SYSOP SAVENODES
  326.  
  327.  
  328.  
  329. John Wiseman, G8BPQ
  330. 31.8.92
  331.